home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / mme010.zip / MM_EDIT.DOC next >
Encoding:
Text File  |  1990-12-09  |  6.9 KB  |  225 lines
  1.                       ┌──────────────────────┐
  2.                       │ MM_EDIT Rev 0.1 beta │
  3.                       └──────────────────────┘
  4.  
  5. MM_EDIT is intended to be used as a MMENU entry in GT16, where it will
  6. allow a caller with appropriate permission to *edit* the current message.
  7.  
  8. MM_EDIT performs the authorisation, administration and replacement
  9. of the edited message.  It uses an external editor, theoretically allowing
  10. you some freedom of choice in choosing the editor and in redirecting the
  11. output to the com port.
  12.  
  13. However, for the moment it comes only with sufficient instructions to get
  14. it to work with RQ.EXE, a configured version of Qedit c 2.08 from Semware,
  15. and Marshal Dudley's Doorway.
  16.  
  17.  
  18. Notes
  19.  
  20. a)      MM_EDIT requires features of GT16.  It will *not* work with earlier
  21.         releases of GT.
  22.  
  23. b)      This is a beta test copy.  Please watch it carefully.  In
  24.         particular, you should be ensure that your editor does not grant
  25.         unintended facilities to callers, the most likely of which are
  26.         described later.
  27.  
  28. c)      You will also require, if you do not already have them :
  29.  
  30.         i)     Qedit 2.08 from Semware
  31.         ii)    Marshal Dudley's Doorway
  32.         iii)   Stackey
  33.  
  34.         most of which you probably already have or will easily find
  35.         on one of your local GT boards.
  36.  
  37.  
  38. ┌──────────────────────┐
  39. │ Security Limitations │
  40. └──────────────────────┘
  41.  
  42. A caller without SY permission (ie, an ordinary caller) is permitted to
  43. edit a message with mm_edit if, and only if :
  44.  
  45. a)      The caller can read the message (since, when set up as described,
  46.         only GT's "current" message can be edited).
  47.  
  48. b)      The message originated on your own board, or in a message area
  49.         which you sponsor, and the caller wrote the message.
  50.  
  51. c)      The message has not already been received or bagged.
  52.  
  53.  
  54. MM_EDIT will permit anybody with SY permission to edit ALL messages.
  55. In most cases, this will apply only to yourself as sysop.
  56.  
  57.  
  58.  
  59. ┌────────────────────────────┐
  60. │ Configuring GT for MM_EDIT │
  61. └────────────────────────────┘
  62.  
  63. First, study the description of the MMENU entry as described in the
  64. GT16 revision document.
  65.  
  66. The command ME is suggested, for uniformity, but you can choose any
  67. 2 character code.  Similarly, it is suggested that you call the batch
  68. command MME.BAT.
  69.  
  70. If you have no other MMENU entries, possible entries in SYSOP.BBS are :
  71.  
  72. Line 97:    "\r(S)can  (Q)uit (T)hread (ME)MsgEdit  Msg(number)"
  73.  
  74. Line 220:   "MMENU=[ME]mme"
  75.  
  76.  
  77. Note 1:     The sysop.bbs line numbers might change with future releases.
  78.  
  79. Note 2:     When you have mm_edit working, you may find you have enough
  80.             space to avoid overlays, ie :
  81.  
  82.                 "MMENU=[ME]mme;&"
  83.  
  84.             See GT16 docs for information.
  85.  
  86.  
  87. ┌─────────────────┐
  88. │ Creating RQ.EXE │
  89. └─────────────────┘
  90.  
  91. You will not find RQ.EXE available anywhere, but you can make it yourself
  92. from by configuring Qedit version 2.08, using the files and procedures
  93. described here.
  94.  
  95. The configuration files as delivered will probably NOT work with versions
  96. of Qedit other than 2.08.
  97.  
  98. a)      Make the directory where you have unzipped these files the current
  99.         directory.
  100.  
  101. b)      Ensure that you know where Qedit's Q.EXE can be found and that
  102.         QCONFIG.EXE is either in the current directory or somewhere in your
  103.         DOS path.
  104.  
  105. c)      Execute RQ_GEN.BAT with a single argument specifying the directory
  106.         containing Q.EXE, eg :
  107.  
  108.                 rq_edit c:\bin
  109.                 
  110. The result should be a file RQ.EXE which should be moved to a convenient
  111. directory for execution.
  112.  
  113. You can if you wish reconfigure the colours by running QCONFIG again
  114. manually.  But you should verify that the results look sensible on
  115. both colour and mono screens.
  116.  
  117.  
  118. ┌──────────────────┐
  119. │ The MME.BAT file │
  120. └──────────────────┘
  121.  
  122. In this file, you have to :
  123.  
  124. a)      perform redirection
  125.  
  126. b)      execute mm_edit with appropriate parameters.
  127.  
  128. If DOORWAY is used, then redirection and editing can be performed with a
  129. single command.
  130.  
  131. You may need to edit the example, which assumes that GTPATH is on drive C
  132. and all files are in a MME subdirectory of GTPATH containing :
  133.  
  134.         MM_EDIT.EXE     The program enclosed
  135.         MME.INI         A text file to display to the caller
  136.         RQ.EXE          As you created it above.
  137.  
  138. Typical contents would be :
  139.  
  140. c:
  141. cd %gtpath%\mme
  142.  
  143. if "%1" == "local" goto mmelocal
  144. if "%1" == "LOCAL" goto mmelocal
  145.  
  146. doorway COM%2 /S:* /G:ON /V:D^Z /I:mme.ini /p:mm_edit.exe %3 %4 rq.exe $m mme.jot
  147.  
  148. goto mmedone
  149.  
  150. :mmelocal
  151.  
  152. mm_edit.exe %3 %4 rq.exe $m mme.jot
  153.  
  154. :mmedone
  155.  
  156. Note:   It is desirable to modifiy the /S parameter to add a time limit to
  157.         the edit.  This is done by running DRWYUTIL.
  158.  
  159.  
  160. ┌─────────────────┐
  161. │ The GTLOGON.BAT │
  162. └─────────────────┘
  163.  
  164. Some people may finds their way into mm_edit's jotter, so it is desirable
  165. to include a command in your GTLOGON.BAT file :
  166.  
  167.         del %gtpath%\mme\mme.jot
  168.  
  169. It goes in the logon batch rather than mme.bat so they can carry forward
  170. its contents from one message to the next, and even between message bases,
  171. during the same call.  But it has to be deleted here so that each caller
  172. begins with an empty jotter.
  173.  
  174.  
  175. ┌───────────────┐
  176. │ Other editors │
  177. └───────────────┘
  178.  
  179. In practice, your freedom in choosing an editor is *severely* limited.  You
  180. must be very careful that an alternative editor does NOT :
  181.  
  182. a)      have any command which gives the caller access to the DOS shell
  183.         or the ability to execute arbitrary DOS commands, eg DEL *.*.
  184.  
  185. b)      allow the caller to read any files other than those specified on
  186.         the command line, eg GTPASSWD.BBS.
  187.  
  188. c)      allow the caller to rename the current file to something else,
  189.         eg \autoexec.bat.
  190.  
  191. d)      prompt for an alternative filename if it is unable to save the
  192.         file.
  193.  
  194. Obviously, an editor with any of those features would allow the caller to
  195. walk over your system in one way or another, and since most editors are
  196. intended for local users where no such security is required, most editors
  197. do NOT fulfill the above requirements.
  198.  
  199.  
  200. ┌─────────┐
  201. │ Testing │
  202. └─────────┘
  203.  
  204. Even if you use the RCONFIG.DAT and RQ_GEN.BAT files, I suggest you give it
  205. a thorough test to ensure that none of the above features have been
  206. enabled, before letting users loose on it.
  207.  
  208. You should also check that it is not allowing the wrong messages to be
  209. edited, and that a lost carrier while in the editor will exit gracefully
  210. with no hangups or other adverse effects.
  211.  
  212.  
  213. ┌─────────┐
  214. │ General │
  215. └─────────┘
  216.  
  217. Copyright of the material in this Zip belongs to Harry Green, GT Net
  218. 050/003, but may be freely used by registered GT16 sysops at their own
  219. risk for beta testing purposes.
  220.  
  221. Any problems, please let me know either by netmail or via the MMR beta
  222. echo, E02/355.
  223.  
  224.  
  225.